home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
ShareWare OnLine 2
/
ShareWare OnLine Volume 2 (CMS Software)(1993).iso
/
prog
/
bldr10b.zip
/
README.1ST
< prev
next >
Wrap
Text File
|
1993-04-14
|
7KB
|
174 lines
Builder 1.0 Late Breaking News and Installation Instructions.
First the News...
o If you get the error 'CONFIG.SYS FILES too low set to a minimum of 21',
edit or add the FILES= line in your CONFIG.SYS file and set to a number
greater than or equal to 21 (FILES=21). If you need to make this change
be sure to reboot before executing BUILDER again. See your DOS manual for
further information on the FILES= CONFIG.SYS command.
o If you get the error 'CLIPPER Environment F Parm too Low Set to a
Minimum of F21', enter the dos command:
SET CLIPPER=F21
at the DOS command line before entering Builder. Put this command in
your AUTOEXEC.BAT file if you continue to use BUILDER.
o In BUILDER when moving window elements the control down arrow and control
up arrow on some computers doesn't work. I added control page down and
control page up which may be used if control up/down arrows do not.
o In BUILDER small comment windows have been added before entering window
data (20 characters), these are used in building a procedure map at the
beginning of the generated source code file and is VERY useful in keeping
track of the code. It is strongly reccomended that you use them.
********* CHANGES TO LIBRARY ROUTINES **********
o REL_MAINT - This is documented in LIBRARY.DOC as a procedure, and is
now a function. The first four parameters are incorrectly documented.
They should be four numerics of the box coordinates. Parm one is the
box top row, parm two is the box left column position, parm three is the
bottom box row, and parm four is the rightmost column position.
Also for REL_MAINT, the GET??? proc you create will be passed one
parameter. This parameter will be a "A", "C" or "" (nul). "A" is passed
if the GET??? proc is being executed just prior to an ADD. "C" is passed
if the GET??? proc is being executed just prior to a CHANGE. Nul is passed
when the GETs will be followed by a CLEAR GETS.
=============================================================================
Now the Installation Instructions.
=============================================================================
Since this system is geared toward programmers I have chosen not to include
a fancy installation routine. Even so installation is quite simple. It
includes five simple steps:
1. Be sure you have all the files.
2a. Rename the library you will be using for your version of Clipper.
2b. Copy the three BUILDER files to the appropriate subdirectories.
2c. Modify the batch file you will be using in your compiles.
3. Print the documentation.
Now lets get to it...
Step 1.
Be sure you downloaded or obtained both .ZIP files! BLDR10A.ZIP and
BLDR10B.ZIP. If either one is missing the system will not work.
Once you have both files. Unzip them into a temporary work subdirectory and
verify all the files against the list in the file PACKING.LST. If any
file(s) are missing the system may be unusable!
Step 1 completed!
Step 2.
A. Decide which version of Clipper you will be using, Summer '87 or Version
5.x.
If you will be using the Summer '87 version, execute the following DOS
command:
RENAME BUILDER.S87 BUILDER.LIB
If you will be using Version 5.x of Clipper, execute this command:
RENAME BUILDER.C50 BUILDER.LIB
Step 2a completed!
B. Copy the BUILDER files to their appropriate subdirectories.
Summer '87 users:
Make sure you have your DOS Path set to the subdirectory where the
CLIPPER.EXE (compiler executable) file is located. (usually C:\CLIPPER)
Copy the following files to the subdirectory where the file CLIPPER.EXE
is located:
BUILDER.EXE
BREPORT.EXE
Copy the file BUILDER.LIB to the subdirectory where the file CLIPPER.LIB
is found, again this is usually C:\CLIPPER
Version 5.x users:
Make sure you have your DOS Path set to the subdirectory where the
CLIPPER.EXE (compiler executable) file is located.
(usually C:\CLIPPER5\BIN)
Copy the following file to the subdirectory where the file CLIPPER.EXE
is located:
BUILDER.EXE
BREPORT.EXE
Copy the file BUILDER.LIB to the subdirectory where the file CLIPPER.LIB
is found, usually C:\CLIPPER5\LIB
Step 2b completed!
C. If you use .LNK files, be sure to include BUILDER in your library search!
Since a different .LNK is used for every program I will assume you already
know how to add this for your particular linker.
If you use the DOS command line when executing your linker modify your
batch file to search the BUILDER library. Use the following examples as
a guide:
PLINk86 users:
plink86 fi %1 lib clipper,builder,extend
note: The ORDER is IMPORTANT!! BUILDER must precede EXTEND !!
Your best bet is to put BUILDER right after CLIPPER in the
library listing.
RTLINK users:
Change the following line in the CL.BAT file:
if not errorlevel 1 rtlink file %1
to look like the this:
if not errorlevel 1 rtlink file %1 lib builder
Step 2c completed!
3. Print the documentation.
You may skip this step if you are just starting your evaluation, no sense
wasting all that paper/time/ink/toner on a product you haven't decided to
use, right? If so remember that BUILDER creates a number of files for
itself. The best approach (and the one I use) is to create a separate
subdirectory for each application you will write. Select the empty
subdirectory and type BUILDER at the DOS prompt to get started.
If you do accidentally invoke BUILDER in a subdirectory and want to rid
it of BUILDERs files, use the following DOS commands to get rid of them.
DEL *.BL?
DEL OPTIONS.DBF
But then maybe you've decided BUILDER will make your programming a whole
lot easier and have found you really NEED a copy of the library
documentation. Well you might as well print the other stuff too, never
know what interesting tidbits lurk in there! Be sure the DOS PRINT command
is in your DOS PATH and type the DOS command "PDOC" to print all the
BUILDER documentation.
If you lost PDOC.BAT the print order I like is:
PRINT WARRANTY.DOC
PRINT LICENSE.DOC
PRINT BUILDER.DOC
PRINT BREPORT.DOC
PRINT LIBRARY.DOC
Step 3 completed!
Good Luck and happy BUILDERing if you have difficulty, even if you are not a
registered user please feel free to call Mark @ (612) 699-8672